Here's a program that helps you find your way from hex to inverted decimal and back again. 


To and Fro with Apple’s 
Inverted Decimal Code 


je Apple II, like many other mi- 
crocomputers, has two ways of 
calling out locations in its address 
space. 

If you are using assembly or ma- 
chine language, the 65536 locations 
in the address space are called out 
with a hexadecimal code, ranging 
from 0000 to FFFF. 

If you are using Integer BASIC or 
another higher-level language, these 
same address locations are called out 
as a decimal number, ranging from 
— 32768 to +32767. Decimal num- 
bers are more useful in BASIC be- 
cause they eliminate the strings you 
might have to use for the hex A, B, C, 
D, E and F values that stand for deci- 
mal 10 through 15. 

The obvious thing to do is to let 
each decimal location be the same 
numeric equivalent of each hex loca- 
tion. But this would take numbers 
that go from 0 to 65535, and Apple's 
Integer BASIC only allows numbers 
from — 32767 to +32767. 

To beat this problem, the Apple 
people invented an inverted decimal 
code. It uses the bottom half of the 
memory as direct numeric equiva- 
lents and the top half of the memory 
as upside down decimal negative val- 
ues. This is roughly akin to Apple II's 


CALL (-32767-1) 
PRINT PEEK (-32767 - 1) 


Table 1. Location hex 8000 is defined as in- 
verted decimal — 32768. Here are two ways to 
get there without an error message. 
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complement notation, where some of 
the numbers seem to be heading the 
wrong way at first glance. Fig. 1 
shows two ways the Apple address 
space is mapped. 

For locations hex O to 7FFF, the 
decimal code is the same as its hex 
value. Decimal 0 to +32767 goes 
with hex 0 to 7FFF. For locations hex 
8001 through FFFF, the decimal code 
counts backwards, and with a minus 
sign. This way, hex FFFF is decimal 
—1; hex FFFE is decimal —2. The 
down counting continues to —32767 
at hex 8002, and finally —32767 at 
hex 8001. 

Location hex 8000 is complex. I'll 
return to it later. It is coded as deci- 
mal —32768, but you can’t get there 
from here without using some tricks. 


Why Convert? 


Why would you ever have to worry 
about these two codes? Any time you 
write a BASIC program, if you want 
to turn loose the full power of the 
monitor, you have to use the inverted 


APPLE 0 
ADDRESS 
SPACE 


FFFF =) -0000! 


Cte es 
8001 cert -32767 
HEX CODE 


(MACHINE ) 


INVERTED 


8000 feaheyiy] 4 -32768 DECIMAL 
CODE 


7FFF 


ea) 752767) (Basic) 


0000 mums +00000 


Fig. 1. Two ways of mapping Apple’s address 


decimal code to call whatever it is 
you are after. If you want to change 
or look at a memory location in your 
machine, you also have the PEEK and 
POKE commands, also called as deci- 
mal numbers. 

Some locations and sequences may 
make much more sense or appear 
more regular in hex than in inverted 
decimal. The screen locations for col- 
or graphics, hi-res graphics and the 
alphanumeric characters are much 
simpler to understand and much 
more "‘logical’’ in hex notation than 
in inverted decimal. So switching the 
coding can sometimes give you in- 
sight into what is happening, or point 
to a newer or better way of doing 
things. 

Finally, if you are studying some- 
one else's BASIC program and see a 
mysterious CALL 1002, how can you 
tell what it means? Only with a back 
and forth conversion can you find out 


fet 
ca 


(1) WRITE THE HEX ADDRESS HERE 


(2)REPLACE LETTERS WITH NUMBERS 


AzIO Bell C=l2 
O=1I3 E=I4 F=I5 


(3)MULTIPLY AND ADD. 


(4) SUBTRACT 


(S)PICK WHICHEVER ANSWER, 1 OR O IS 
CLOSEST TO ZERO 


space—hex for machine language and inverted Fig. 2. Worksheet to convert hex locations to in- 


decimal for BASIC. 


verted decimal locations. 


what the program is really up to. 

For some reason, people avoid try- 
ing to convert between these two 
codes. Sometimes you can cheat by 
finding a code equivalent that may be 
nearby, and then counting down or 
up in the right direction. But, that's 
no fun, particularly if you go the 
wrong way and bomb the machine. 
And this avoids learning to do things 
the right way in the first place. 

You can also generate a list and 
look up all the values in either direc- 
tion. But this takes 65536 double en- 
tries and will produce a bunch of 
computer printouts. There is some- 
thing better. 


Scratchpad Conversions 


You can look at four ways of get- 
ting from hex to inverted decimal and 
back again. The worksheet methods 
let you use a calculator and a sheet of 
paper. This is convenient if your Ap- 


(1) WRITE THE HEX ADDRESS HERE 


(2)REPLACE LETTERS WITH NUMBERS 


AzIO Bell Czl2 
OzI3) ErI4 F215 


jc fo ts] 7 | 
pz} ofs] 7) 


(3) MULTIPLY AND ADD: 


rorat [+[4]9[2[3]s5 (1) 


= iG) "Sse © 


-[]efe}ol7 jim 


(5)PICK WHICHEVER ANSWER, I OR 1 IS 
CLOSEST TO ZERO 


(4) SUBTRACT 


Fig. 3a. Two examples converting hex to inverted 
decimal. 


(1I)WRITE THE HEX ADDRESS HERE 


FR Ew ic 
(2)REPLACE LETTERS WITH NUMBERS o | ane | 7 | 


AzIO0 Bell Cz12 
OFI3 E214 Frid 


(3)MULTIPLY AND ADD: 


rota. | +]o}1fofe{3jm 


=- & S_s 3° 6 


(4)SUBTRACT 


[-le}s fet? ]3 fm 
(5)PICK WHICHEVER ANSWER, I OR IT IS 
CLOSEST TO ZERO 


Fig. 3b. (Second example.) 


~ See List of Advertisers on page 210 


ple isn't up, or if you don‘t want to 
change what is in it, or if you just 
have a single location or two to con- 
vert. 

Fig. 2 shows a worksheet to convert 
hex locations to inverted decimal lo- 
cations. You can put another pad of 
paper along the right margin of the 
worksheet and work in parallel, us- 
ing the same worksheet over and 
Over again. 

You use this worksheet by writing 
the hex address at the top and then 
replacing the letters with their deci- 
mal 10 through 15 equivalents. You 
then go through the multiply-and-add 
song-and-dance shown, scaling the 
digits by 1, 16, 256 and 4096. Total I 
in the figure is a direct decimal con- 
version of the hex address space. In 
other machines, this may be all you 
need. 

But, for the Apple, you have to in- 
vert the decimal code for everything 
in the top half of memory. To do this, 
you subtract 65536 to get a new an- 
swer, II. You then pick answer I or II, 
the one nearest zero, as the correct 
conversion. Addresses 0000 to 7FFF 
will convert directly, while 8001 
through FFFF will convert to the 
down-counting negative decimal val- 
ues. 

Fig. 3 shows two sample calcula- 
tions. Here you prove that the Apple 
memory location ‘‘turn on the hi-res 
graphics’’ hex C057 is decimal 
— 16297 (Fig. 3a). A second example 


+, - SIGN 
GOES HERE 
65 5 3 6 
(A) WRITE THE DECIMAL ADDRESS HERE I | L] 


erie tals -,o0 tHe sustraction L*] | | | | 


AND PUT RESULT HERE 


(C) DO THE DIVISIONS SHOWN BUT PUT 
ONLY WHOLE NUMBER RESULTS IN 
THE BOXES 


H3 


SUBTRACT AND PUT REMAINDER HERE —{ | 


(0) REWRITE HI TO H4 HERE. SUBSTITUTE LETTERS A-F 
FOR DECIMAL !0 TO 16 
H4_ H3_ H2 HI 


Fig. 4. Worksheet to convert decimal locations to 
hex locations. 


AziO Beit Cz12 
OzI3 E14 Fel5 


‘4 Model Il 64K 
$3375 


These are just a few of our many 
fine offers — computers, periph- 
erals, modems, printers, disc 
drives and an unusual selection 
of package values. Call TOLL 
FREE today and check us out for 
price and warranty. 


Pure Radio Shack equipment warranteed 
at any Radio Shack store or dealer” Fac- 
tory warrantees on Apple and Atari equip- 
ment. Other equipment carries manufac- 
turer's warranty or Computer Plus 180 
day extended warranty. Combined war- 
rantees carry Computer Plus 180 day war- 
ranty or original manufacturer's warranty. 


DEALER INQUIRIES ARE INVITED 
Prices subject to change without notice 
TRS-80 Is a registered trademark of Tandy Corp. 


call TOLL FREE 
1-800-343-8124 


al 


Write for your 
free catalog... 


Dept. K 


245A Great Road 
Littleton, MA 01460 


(617) 486-3193 
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(Fig. 3b) shows that the upper right- 
hand character on the screen is both 
hex 0427 and decimal 1063. 

Fig. 4 gives you a new worksheet to 
go the other way—from inverted dec- 
imal to hex. Here, you write the deci- 
mal address at the top. If the decimal 
address is positive, you do nothing to 
it. If the decimal address is negative, 
you subtract the address from 65536. 
Either way, you get a positive num- 
ber from 0 to 32767. 

You then go through a funny game 
called a math iteration. You try divid- 
ing by 4096 and write only the whole 
number result (the part of the answer 
to the left of the decimal point on 
your calculator) in box H4. Now, you 
multiply back only the whole num- 
ber part of H4 and subtract to get a re- 
mainder. 


‘68’ MICRO 
JOURNAL .. 


6800-6809-68000 
* The only ALL 68XX Computer Magazine 


Foreign Orders—Add: 
Air Mail $35.00 /Year-Surface $12.00 /Year 


Canada & Mexico Add $5.50 to USA Rate 
1-Year $18.50 2 Years $32.50 


3 Years $48.50 
OK, PLEASE ENTER MY 
SUBSCRIPTION 
Bill my: M/C 0 — VISA O 


Card # 

Expiration Date 

For 0 1-Yr. O02 Yrs. 03 Yrs. 
Enclosed: $ 

Name 

Street 

City 

State Zip 
‘68’ MICRO JOUNRAL 1m 


3018 Hamill Road 
HIXSON, TN 37343 


CHEAP CHIPS . . . ARE NO BARGAIN 
BUYING ADD-ON MEMORY? 
GET THE BEST!!! 


M enory failures cost you time and money. Japanese 16k 
RAM chips have a one-to-ten in-service failure ratio to U.S. 
Chips--from a study by R. Anderson, Computer Div., 
Hewlett-Packard. reported in The Economist, 4-26-80. 

We offer 4116 chips by Fujitsu, NEC, Hitachi, Toshiba 
and Mitsubishi . . . for most popular computers and 
expansion memory boards, including: 

*Apple *Ali TRS-80's *New Pet °Heath H-89 
*Superbrain *Expandoram *Many Others 
4116 DYNAMIC RAMS THE BEST 
200nsec Plastic $27.70, Ceramic $37.95 
150nsec Plastic $31.95, Ceramic $41.95 
STATIC RAMS 
2114 450nsec $3.30, 300nsec $3.90; 2101 $2.90. 

EPROMS (450 nsec std; ask for hi-speed if required) 
2708 $4.80; 2716 5V+12V $9.40; 2716 5V $9.70; 
2732 $18.90. 

We'll beat any legitimate price for comparable chips. Hi- 
volume users, dealers, or clubs, ask for quantity discounts. 
SHIPPING: to $25, $2; to $50, $1; over $50, FREE. 
COD: +$1.40. 

DISCOUNTS ON TOTAL: over $100, 5%; over $200, 10%. 
MINIS & MICROS INC. © 29486 Trallway 
Agoura, CA. 91301 e (213) 342-4535 

CA. residents add 6% sales tax ~391 


2 YEAR WARRANTY »* CALL US ANYTIME 


WE'LL BEAT ANY DEAL FOR COMPARABLE CHIPS 
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Repeat this process for 256, 16 and 
finally 1. Each time, use only whole 
numbers. This gives you your raw 
hex digits. Finally, put all your H1 to 
H4 digits in order and replace the 
numbers above 9 with their A-F 
equivalents. 

Two examples in Fig. 5 show the 
Apple locations that toggle the speak- 
er and switch the screen from normal 
to inverse mode. 


Conversion Programs 


Listing 1 shows you a program to 
convert from hex to inverted decimal 
code. Steps 100-130 do some house- 
work for you, clearing the screen and 
asking you to input the hex address. 
This address is read as a string (re- 
member those letters!) called HEX$. 
You then read each piece of the string 
in steps 140-170. If you have a letter, 
step 170 changes the letter to its nu- 
meric 10-15 equal. 

In step 190, test to see if you are 
working on the top half of memory. If 
you are, subroutine 400-420 comple- 
ments the hex code for you and de- 
cides to print a minus sign in front of 
your final answer. If you are on the 
bottom half of memory, skip this 
step. 

Then calculate the decimal equiva- 
lent in step 200 and print the answer 
in 210. Steps 220 and 230 do some 
formatting and repeating. 

You can test this program with any 
of the previous examples. After your 


+, - SIGN 


GOES HERE B cull, ee. 
(A) WRITE THE DECIMAL ApoREss HERE| -| 1 [6][3 [3 [6 | 


(B) IF (A) IS +, REWRITE IT HERE 
IF (A) 1S -, DO THE SUBTRACTION 
AND PUT RESULT HERE 


(C) DO THE DIVISIONS SHOWN BUT PUT 
ONLY WHOLE NUMBER RESULTS IN 
THE BOXES. 


+4096: [J x 4096 = 


[4 }sfo}s{e| 
SUBTRACT AND PUT REMAINDER HERE 


oo 
H3 
Lese(e]ee - BEDE 


SUBTRACT AND PUT REMAINDER HERE 


(0) REWRITE HI TO H4 HERE SUBSTITUTE LETTERS A-F 
FOR DECIMAL (0 TO 16. 


H4_H3 H2 HI 


adage Po |? [o | 


Fig. 5a. Two examples converting inverted deci- 
mal to hex. 


A=10 B2ll C=I2. 
D213 E214 FrI5 


first answer, hit the carriage return to 
enter your next conversion. Do this 
till all the numbers you need are con- 
verted. 

The reverse program trip of invert- 
ed decimal to hex is shown in Listing 
2. It is somewhat longer and takes a 
fancier string. Again, start with 
housework in steps 100-130. Step 
140 erases a question mark that 
messes up the display and starts you 
off assuming a lower half conversion. 
If you are working on the top half of 
the address space, step 150 goes to 
subroutine 400-410 to do repair 
work. 

Step 160 sets up the string that will 
automatically convert numbers 10 to 
15 to their hex letters. Lines 190 
through 220 execute the conversion 
iteration; step 240 adds 8 to the left- 
most hex digit if you started out with 
a negative inverted decimal number. 
Lines 250-260 print out your answer, 
while 270 and 280 close the loop to let 
you repeat. , 

Operation is about the same as the 
earlier program. Type RUN and en- 
ter the code to be converted. The an- 
swer appears. Then use a carriage re- 
turn to start entering a new number. 
CTRL C ends the program and re- 
turns you to Integer BASIC. 

You might like to test this program 
to prove that step 140 does, in fact, 
erase a question mark on the screen. 


Which Way? 
Pick the worksheet methods if you 


+, - SIGN 
GOES HERE Beet bz 
(A) WRITE THE DECIMAL ADDRESS HERE] +/0]0[0]5 [0 | 


(B)IF (A) tS +, REWRITE IT HERE 


IF (A) IS -, 00 THE SUBTRACTION |+fofofo]s}o| 


AND PUT RESULT HERE 

(C) DO THE DIVISIONS SHOWN BUT PUT 
ONLY WHOLE NUMBER RESULTS IN 
THE BOXES. 


H4 _ a 


SUBTRACT AND PUT REMAINDER HERE 


(D)REWRITE HI TO H4 HERE SUBSTITUTE LETTERS A-F 
FOR DECIMAL IO TO 16. 
H4 H3 H2 HI 


ee ee 2 | 


Fig. 5b. (Second example.) 


have only a couple of conversions, or 
are away from your computer. Use 
the programs for everything else. 
You might like to combine both pro- 
grams into one that goes either way. 
You can also use trial and error to let 
one program do the backwards trip 
for you. 


The Hex 8000 Problem 


Location hex 8000 looks confusing. 
The Apple people call this decimal 
— 32768, but, if you try getting direct- 
ly at 8000, you will probably get '’> 
32767 ERR"’. Fortunately, location 
8000 rarely needs code conversion. 

But there is a way. It is sneaky, but 
it works. Apple allows a value of 
— 32768 inside the machine. It just 
doesn't let you put this number into 


the machine or take it back out any 
direct way. 

Table 1 shows ways to get at this lo- 
cation. You have to give the Apple 
something to do that will make it in- 
ternally compute a value of — 32768. 
For instance, PEEK (-— 32767 —- 1) will 
also work without an error message. 
Should you have some machine-lan- 
guage routine at 8000, CALL ( — 32767 
—1) will also work without an error 
message. 

So, don't be afraid of those funny 
number games involved in getting 
from hex to inverted decimal and 
back again. These codes are simple 
and easy to use. The two codes and 
their conversion are versatile tools 
when you learn to convert them 
quickly. 


100 REM * APPLE HEX TO DECIMAL 


110 DIM HEX$(4),A(4) 

120 CALL -936: VTAB 6: TAB 10 
130 INPUT ‘HEX ADDRESS ",HEX$ 
140 FOR N=1 TO4 

150 A(N) =ASC(HEXS(N,N)} 

160 A(N)=A(N) -176 

170 IF A(N)>15 THEN A(N) =A(N) -7 
180 NEXT N:HEX$="'" 

190 IF A(1)>7 THEN GOSUB 400 


200 DECIMAL=A(1)*4096 + A(2)*256 + A(3)*16 + A(4] 
210 PRINT : TAB 10: PRINT "IS DECIMAL ";: PRINT HEX$;: PRINT DECIMAL 
220 PRINT : PRINT : PRINT: PRINT : PRINT 


230 INPUT HEX$: GOTO 120 


400 FOR N=1 TO 4:A(N)=15- A(N): NEXT N 


410 A(4)=A(4) +1 
420 HEX$="'-"': RETURN 


Listing 1. Program for hex to inverted decimal conversion. 


REM : APPLE DECIMAL TO HEX 


DIM HEX$(16},A(4) 


CALL —936: VTAB 6: TAB 10 

INPUT "DECIMAL ADDRESS "", DECIMAL 
POKE 1689,160:FIX =0 

IF SGN (DECIMAL)<0 THEN GOSUB 400 
HEX$ =''0123456789ABCDEF"’ 

A(1) =DECIMAL/4096 + 1 

R= DECIMAL MOD 4096 


A(2) =R/256 +1 
R=R MOD 256 
A(3) =R/16+1 


A(4)=R MOD 16+1 


PRINT : TAB 13: PRINT "IS HEX "; 
IF FIX=1 THEN A(1)=A(1)+8 


FOR N=1TO4 


PRINT HEX$(A(N),A(N)}); 
270 NEXT N: PRINT : PRINT : PRINT 
280 INPUT HEX$: GOTO 120 
400 DECIMAL =32767 + DECIMAL +1:FIX = 1 


410 RETURN 


Listing 2. Program for inverted decimal to hex conversion. 
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BASIC A+ for ATARI 


BASIC A+ is from the authors of Atari Basic 


Fully compatible with the popular Atari Basic, our 
much enhanced BASIC A+ adds even more flexibility 
and ease of use, including PRINT USING, WHILE and 
IF ... ELSE, record 1/0, fast binary 1/0, TRACE, 
readable error messages, player-missile graphics, 
and MORE. With a disk and 32K bytes of RAM, you 
can enjoy friendly, powerful BASIC A+ .... $80° 


CP/A is our simple, flexible DOS Control Program 
which INCLUDES an EDITOR/ASSEMBLER/DEBUG 
package. CP/A is file compatible with Atari DOS and 
has a documented interface and expandability. 
Multiple source assemblies, batch processing, 
MORE—only in CP/A $80 
BASIC A+ and CP/A combined $150. $5 shpg. 6% CA tax. 
PLEASE SEE YOUR DEALER FIRST 
OPTIMIZED SYSTEMS SOFTWARE 
10379 Lansdale, Cupertino, CA 95014 
(408) 446-3099 


“Apple version of BASIC A+ requires CP/A. Registered 
trademarks: Atari, Atari 800 by Atari, Inc. 
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TYPRINTER 450 $2100 
45 CHAR/SEC DAISYWHEEL PRINTER/ 
TERMINAL. RS232; IDEAL FOR WORD 
PROCESSING; WILL SUPPORT DIABLO, 
QUME, AND NEC PROTOCOLS 

$2300 


TYPRINTER 550 
SAME AS ABOVE BUT 
55 CHAR/SEC PRINT SPEED 


QUME $1000 

55 CHAR/SEC OEM PRINTER MECHANISM 
SHUGART 8” FLOPPY 
DISK DRIVES 


SA800 SOF T-SECTORED 
SINGLE/DOUBLE DENSITY 


MICROSWITCH KEYBOARDS $85 


HALL EFFECT. ASCII MOD. 74SW12 


INTERFACE $325 
OEM DAISYWHEEL PRINTER INTER- 
FACE. INTERFACES DIABLO OR 
QUME OEM PRINTER TO RS232 OR 
CENTRONICS PARALLEL 


RIBBONS $2.50 
DIABLO HYTYPE 1 OR QUME. CLOTH 
OR MULTI/STRIKE. 1 DOZ. MINIMUM 


COMPUTER DYNAMICS, INC. 


211 WHITE WATER 370 
GREER, S.C. 29651 © (803) 244-7872 


$360 


S-100 6809 
controls floppy 


@ Controls 3 Mini Floppy Drives 
@ Serial RS-232C port with 14 baud rates 
@ Two parallel ports 
@ 16 I/O decoded address lines 
@ 24K bytes of EPROM space, or 12 Kbytes 
of RAM space 
@ Accept all JEDEC pin-out Byte-Wide 
memory ICs 
@ Multi-Vendor software adaptable 
@ Industry, Business, Home and University use 
@ Assembled and tested $395.00. 60 day delivery 
@ Checks or C.O.D. orders accepted 
@ DEALER INQUIRIES INVITED 


LOGICAL DEVICES, INC. .373 
781 W. Oakland Park Bivd. 
Ft. Lauderdale, Fla. 33311 

Tel: (305) 565-8103 
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